Java: CAM v1.1.3 refactoring and new CAM v2.3.0 by mathieu1fb · Pull Request #489 · Orange-OpenSource/its-client

mathieu1fb · 2026-03-09T16:12:58Z

What's new

CAM v2.3.0 support has been added
CAM v1.1.3 has been refactored completely for compatibility, so that both versions can be handled in parallel

Close #485
Close #486

What to do

After reviewing code changes:

Clone the its-client project on your IDE.
Ensure that you have Gradle to be able to build the java/iot3 modules (core, mobility and examples).
Find the Iot3MobilityExample class in the examples module, and set appropriate values for the following fields:

private static final String EXAMPLE_UUID = "uuid";
private static final String EXAMPLE_CONTEXT = "context";
// MQTT parameters
private static final String EXAMPLE_MQTT_HOST = "mqtt_host";
private static final int EXAMPLE_MQTT_PORT = 1883;
private static final String EXAMPLE_MQTT_USERNAME = "mqtt_username";
private static final String EXAMPLE_MQTT_PASSWORD = "mqtt_password";
private static final boolean EXAMPLE_MQTT_USE_TLS = true; // set to true

In the same class, remove the telemetry and LwM2M parameters from the IoT3Mobility builder as they won't be used:

.telemetryParams(EXAMPLE_OTL_SCHEME,
                        EXAMPLE_OTL_HOST,
                        EXAMPLE_OTL_PORT,
                        EXAMPLE_OTL_ENDPOINT,
                        EXAMPLE_OTL_USERNAME,
                        EXAMPLE_OTL_PASSWORD)
.lwm2mParams(
                        EXAMPLE_LWM2M_CONFIG,
                        EXAMPLE_LWM2M_DEVICE,
                        lwm2mConnectivityStatistics)

Run Iot3MobilityExample for a few seconds.
Stop it.
Modify the CamVersion.V1_1_3 parameter in the ioT3Mobility.sendPosition(...) method by CamVersion.V2_3_0.
Run Iot3MobilityExample for a few seconds.
Stop it.

Expected results

During the first run, you should see CAMs v1.1.3 being received and processed (i.e. turned into RoadUser objects).

Raw message received: {"type":"cam","origin":"self","version":"1.1.3","source_uuid":"ora_test_123","timestamp":1773072528767,"message":{"protocol_version":2,"station_id":78486518,"generation_delta_time":64895,"basic_container":{"station_type":5,"reference_position":{"latitude":486252180,"longitude":22434480,"altitude":0}},"high_frequency_container":{"heading":0,"speed":0,"longitudinal_acceleration":0,"yaw_rate":0}}}

Raw CAM v1.1.3: CamEnvelope113[type=cam, origin=self, version=1.1.3, sourceUuid=ora_test_123, timestamp=1773072528767, message=CamMessage113[protocolVersion=2, stationId=78486518, generationDeltaTime=64895, basicContainer=BasicContainer[stationType=5, referencePosition=ReferencePosition[latitude=486252180, longitude=22434480, altitude=0], confidence=null], highFrequencyContainer=HighFrequencyContainer[heading=0, speed=0, driveDirection=null, vehicleLength=null, vehicleWidth=null, curvature=null, curvatureCalculationMode=null, longitudinalAcceleration=0, yawRate=0, accelerationControl=null, lanePosition=null, lateralAcceleration=null, verticalAcceleration=null, confidence=null], lowFrequencyContainer=null]]
New Road User: ora_test_123_78486518
Road User position: lat/lng: (48.625218,2.243448)

During the second run, you should see the exact same with CAMs v2.3.0.

Raw message received: {"message_type":"cam","message_format":"json/raw","source_uuid":"ora_test_123","timestamp":1773070072412,"version":"2.3.0","message":{"protocol_version":2,"station_id":24793671,"generation_delta_time":33372,"basic_container":{"station_type":5,"reference_position":{"latitude":486252180,"longitude":22434480,"position_confidence_ellipse":{"semi_major":10,"semi_minor":10,"semi_major_orientation":0},"altitude":{"value":0,"confidence":15}}},"high_frequency_container":{"basic_vehicle_container_high_frequency":{"heading":{"value":0,"confidence":127},"speed":{"value":0,"confidence":127},"drive_direction":2,"vehicle_length":{"value":1023,"confidence":4},"vehicle_width":62,"longitudinal_acceleration":{"value":0,"confidence":102},"curvature":{"value":1023,"confidence":7},"curvature_calculation_mode":2,"yaw_rate":{"value":0,"confidence":8}}}}}

Raw CAM v2.3.0: CamEnvelope230[messageType=cam, messageFormat=json/raw, sourceUuid=ora_test_123, timestamp=1773070072412, version=2.3.0, message=CamStructuredData[protocolVersion=2, stationId=24793671, generationDeltaTime=33372, basicContainer=BasicContainer[stationType=5, referencePosition=ReferencePosition[latitude=486252180, longitude=22434480, positionConfidenceEllipse=PositionConfidenceEllipse[semiMajor=10, semiMinor=10, semiMajorOrientation=0], altitude=Altitude[value=0, confidence=15]]], highFrequencyContainer=BasicVehicleContainerHighFrequency[heading=Heading[value=0, confidence=127], speed=Speed[value=0, confidence=127], driveDirection=2, vehicleLength=VehicleLength[value=1023, confidence=4], vehicleWidth=62, longitudinalAcceleration=AccelerationComponent[value=0, confidence=102], curvature=Curvature[value=1023, confidence=7], curvatureCalculationMode=2, yawRate=YawRate[value=0, confidence=8], accelerationControl=null, lanePosition=null, steeringWheelAngle=null, lateralAcceleration=null, verticalAcceleration=null, performanceClass=null, cenDsrcTollingZone=null], lowFrequencyContainer=null, specialVehicleContainer=null]]
New Road User: ora_test_123_24793671
Road User position: lat/lng: (48.625218,2.243448)

Note: it is normal if source_uuid, station_id and timestamps differ in your test.

This new implementation should be faster and is clearly versioned. Signed-off-by: Mathieu LEFEBVRE <mathieu1.lefebvre@orange.com>